package com.atguigu.lease.web.admin.controller.apartment;


import com.atguigu.lease.common.result.Result;
import com.atguigu.lease.model.entity.LabelInfo;
import com.atguigu.lease.model.enums.ItemType;
import com.atguigu.lease.web.admin.service.LabelInfoService;
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
import io.swagger.v3.oas.annotations.Operation;
import io.swagger.v3.oas.annotations.tags.Tag;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.web.bind.annotation.*;

import java.util.List;

/**
 * @author spring
 */
@Tag(name = "标签管理")
@RestController
@RequestMapping("/admin/label")
public class LabelController {

    @Autowired
    private LabelInfoService service;

    /*
    - SpringMVC中的`WebDataBinder`组件负责将HTTP的请求参数绑定到Controller方法的参数，
    并实现参数类型的转换。
    - Mybatis中的`TypeHandler`用于处理Java中的实体对象与数据库之间的数据类型转换。
     */


    @Operation(summary = "（根据类型）查询标签列表")
    @GetMapping("list")
    public Result<List<LabelInfo>> labelList(@RequestParam(required = false) ItemType type) {
        System.out.println(type);
        LambdaQueryWrapper<LabelInfo> queryWrapper = new LambdaQueryWrapper<>();
        queryWrapper.eq(type!=null,LabelInfo::getType,type);
        List<LabelInfo> list = service.list(queryWrapper);
        return Result.ok(list);
    }

    /*
    SpringMVC中的`HTTPMessageConverter`组件负责将Controller方法的返回值（Java对象）
    转换为HTTP响应体中的JSON字符串，或者将请求体中的JSON字符串转换为Controller方法中的参数（Java对象），
    例如下一个接口**保存或更新标签信息**
     */

    @Operation(summary = "新增或修改标签信息")
    @PostMapping("saveOrUpdate")
    public Result saveOrUpdateLabel(@RequestBody LabelInfo labelInfo) {
        service.saveOrUpdate(labelInfo);
        return Result.ok();
    }

    /*
    `WebDataBinder`依赖于[`Converter`]
    (https://docs.spring.io/spring-framework/reference/core/validation/convert.html)
    实现类型转换，若Controller方法声明的`@RequestParam`参数的类型不是`String`，
    `WebDataBinder`就会自动进行数据类型转换。SpringMVC提供了常用类型的转换器，
    例如`String`到`Integer`、`String`到`Date`，`String`到`Boolean`等等，
    其中也包括`String`到枚举类型，但是`String`到枚举类型的默认转换规则是根据实例名称（"APARTMENT"）
    转换为枚举对象实例（ItemType.APARTMENT）。若想实现`code`属性到枚举对象实例的转换，
    需要自定义`Converter`，代码如下，具体内容可参考[官方文档]
    (https://docs.spring.io/spring-framework/reference/core/validation/convert.html#core-convert-Converter-API)。
     */

    @Operation(summary = "根据id删除标签信息")
    @DeleteMapping("deleteById")
    public Result deleteLabelById(@RequestParam Long id) {
        service.removeById(id);
        return Result.ok();
    }
}

/**
 * **知识点**：
 * 上述接口的功能是根据**type**（公寓/房间），查询标签列表。由于这个**type**字段在数据库、
 * 实体类、前后端交互的过程中有多种不同的形式，因此在请求和响应的过程中，
 * **type**字段会涉及到多次类型转换。
 * 首先明确一下**type**字段的各种形式：
 * - **数据库中**
 *   数据库中的**type**字段为`tinyint`类型
 *   ```
 *   +-------------+--------------+
 *   | Field       | Type         |
 *   +-------------+--------------+
 *   | id          | bigint       |
 *   | type        | tinyint      |
 *   | name        | varchar(255) |
 *   | create_time | timestamp    |
 *   | update_time | timestamp    |
 *   | is_deleted  | tinyint      |
 *   +-------------+--------------+
 */